home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 71.zip / BS1 part 71 / Caligani24_d1.adf / makermp.lzh / ramps.doc < prev   
Text File  |  1993-02-02  |  4KB  |  94 lines
  1.  
  2. Included here is a program to make images of color transitions - makermp.
  3. makermp requires at least a 68020 processor and 68881 floating point chip
  4. in order to run. It is assumed that the user has a basic understanding of
  5. the Amiga Shell environment and is familiar with text editors.
  6.  
  7. makermp takes an input ".rmp" ramp file containing color transition
  8. descriptions and outputs 6rn format image files which can be loaded into
  9. Caligari and used as texture maps, backgrounds or foregrounds.
  10.  
  11. The format of the .rmp file is very simple and should be made in a text
  12. editor such as 'Ed' that comes with the Amiga. The following is an example
  13. .rmp file:
  14.  
  15. 8
  16. 0.0     0       0   0   255
  17. 0.20    0       0   0   255
  18. 0.45    0       0   50  255
  19. 0.60    0       0   50  255
  20. 0.70    50      0   50  255
  21. 0.80    150     70  0   255
  22. 0.85    0       0   0   255
  23. 1.00    0       0   0   255
  24.  
  25. Now, what does it all mean? The first line is the number of color
  26. transition points in the file. This example has 8. After the count come
  27. the actual transition points. The number in the leftmost column is a
  28. number between zero and one. This number corresponds to a vertical point
  29. on the output image. Zero is the top scanline and one is the bottom
  30. line. For example, if you are making an image 100 lines high, 0.0 is line
  31. 0, 0.5 is line 50, and 1.0 is line 99. Following the transition point
  32. value, on the same line in the .rmp file, are red, green, blue and alpha
  33. values. The RGBA values are in the range 0 to 255 where, for color, 0 is
  34. minimum for each color component and 255 is maximum, and for alpha, 0 is
  35. completely transparent and 255 is completely opaque. Between each color
  36. transition point, the output image will have a completely smooth
  37. transition from one color to the other. If you don't want a smooth
  38. transition, you can put in two different color values with the same
  39. transition point value (i.e. 0.5 34 34 34 255 followed by 0.5 100 0 0 255
  40. will result in an immediate change from dark grey to medium-dark red).
  41. The example .rmp file above will produce the following image:
  42.  
  43. completely opaque (all alpha values opaque)
  44.  
  45. top 1/5 of the image completely black
  46. from 1/5 down to about half way down, a gradual transition to dark blue
  47. from about half way down to 6/10 down, the same level of dark blue
  48. from 6/10 to 7/10 down, a transition to dark purple
  49. from 7/10 to 8/10 down, a transition to orange
  50. a very narrow and quick transition to completely black
  51. the last little over 1/10 completely black
  52.  
  53. This .rmp file was used to create the night.e1d 1D environment map (see
  54. the description of the mktable program below for more info on how to make
  55. a 1D environment out of a .rmp file).
  56.  
  57. The template for  'makermp' is as follows:
  58.  
  59. makermp -r XRES YRES infile outfile
  60.  
  61. replace XRES with the number of pixels wide you wish to make the image.
  62. replace YRES with the number of pixels high you wish to make the image.
  63. replace infile with the name of the .rmp file that contains the list of
  64. transition points as described above. You must give the full name
  65. including any extensions.
  66. replace outfile with the path and name of the output .6rn file you wish
  67. to create. The file will be created with exactly the name you specify
  68. with no extensions added.
  69.  
  70. For example:
  71.  
  72. makermp -r 736 482 back.rmp Caligari:night.6rn
  73.  
  74.  
  75. Making 1D environment maps:
  76.  
  77. It is possible to make 1D environment maps from the same .rmp file
  78. described above. To make a 1D environment, use the mktable program supplied
  79. in the RenditionDI: directory as follows:
  80.  
  81. RenditionDI:mktable infile CalEnviron:outfile.e1d
  82.  
  83. replace infile with the name of the .rmp file that contains the list of
  84. transition points as described above. You must give the full name
  85. including any extensions.
  86. replace outfile with the name of the output 1D environment file. The
  87. extension .e1d MUST be supplied, or Caligari will not recognize it. In
  88. addition, it must be placed in the CalEnviron: directory, or it will not
  89. be recognized.
  90.  
  91. For example:
  92.  
  93. RenditionDI:mktable gray.rmp CalEnviron:gray.e1d
  94.